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1.0 INTRODUCTION 


The Pixel Sketch/Graphics Editor by Lemke Software Developement 
is a graphics design program that works with the Standard video 
mode, the Extended Colcr video mode, and Cin a limited fashion) 
the High Resolution vides mode of the TS e068 Color Computer. 


PS/GE 2068 uses Joystick commands and simple key commands’ to 
draw anc edit your graphic designs. Each pixel on the 256x176 
Pixel screen (512x176 in the hAigh resclution video mode) can be 
used. Simple key commancs are used to change ink colors, flash 
or bright attributes, cr paper cclor. Use the joystick to move 
the plot curser around the screen. The "Fire” button turns’ the 
curser draw Function on anc off. Made a mistake? No problem. The 
erase Functicn ceverses the curser to erase instead of draw so 
errsrs are easily removec. PS/SE COBE commands can draw lines, 
arcs, anc circles too. You can also add text! Your X and Y 
coordinates are displayec at all times For easy reference. 


PS/GE 2068 also does For grashics what a good text editor does 
For word processing. You can duslicate part of a screen, erase 
all or part of a screen, scale up or down, rotate (2 dimensional 
Flat rotation) by 90 degrees, saint, and shade. You can _ make 
mircsr images, invert (reverse the ink and paper pixels), and 
more! You can merge des:gns From 1 screen into another 
Creleccating its position at the same time). You can digitize a 
screen segment tc create user defined graphics characters. You 
control the size anc sheave of each screen segment operated on. 
Machine language is extensive ss the response time is fast. Each 
Function is Followed up with a YES/NO save question that will 
restore your previous screen just in case an (OOPS!) error gets 

commanded. 


Loading 


1.1 INITIALIZATION 
Load "PS/Ge e068” or Load "””. 


PS/GE C068 will load in about S minutes. It will auto-run and 
alert you to "STOP TAPE”. Please do so. CIF the High Resolution 
video mode is used, additional machine code must be loaded from 
the tape). 


As you begin, you will be askec to select a background paper 
color. Press @ number key (0 to 7). The resulting color is 
displayed above the key, for example 1 is blue and 7 is’ white. 
This color can be changed (locally) as described below. 


After the paper color is selectec, you will be askec to select 
the cesired video mode. Press "0" for the Standard video mode, 
press "1" for the Extended Color video mode, and press "2" for 
the High Resolution video mode. The bulk of the user guide is 
directed toward the Standard and Extended Color video modes. The 
High Resolution viceo mode is limited to the curser draw/erase 
Functions, the paper color selection, erase (clear screen), hard 
copy print CeO4O printer), text print, load, and save functions. 
See appendix "C” cf the "2066 Personal Color Computer User 
Manual” for a brief description of these video modes and their 
various characteristics. Also, see sections 2.11 and &.4 for 
more discussion of video mode use and selection. If you use the 
high resolution video mode, you will be prompted to "START 
TAPE”. Please do sc. The "high resolution” machine code routines 
Follow the basic program and machine code on the tape. 


PS/GE e068 has at uour dispesal @ descriptive menus for quick 
and easy reference: the F:xel Sketch (PS) menu lists all of the 
Functions used to develope your graphics design (Press "M” for 
the PS Menu); the Graphics Editor (GE) menu lists all the 
Functions used to edit your des:an (Press "X" for the GE Menu). 


e.0 PIXEL SKETCH MENU 


The Pixel Sketch (PS) menu can be listed on the screen by 
pressing "M". CWarning: be sure that you do not have the GE menu 
on the screen before you press "NM". IF you press "MN" with the 
Graphics Editor menu on the screen PS/GE e068 will interpret 
this as a "“NMerge” command.) To activate any of the PS functions, 
press the key associated with that option. A status indicator 
will Flash briefly at the bottom/center of the screen to verify 
your command. If a Function requires additional data it will 
prompt you For it. For example: the CIRCLE command will prompt 
you for the desired radius length. PS/GE COGB will draw a circle 
with the specified radius at the present curser location. See 
section 2.3 for more details about the circle function. 


The Following is a copy of the PS Menu. 
PIKEeEtL SKETCH MENU 


Press 0 to 7 for Ink Colors 
B for Bright on/off 
C for a Circle 
D for a Line or Arc 
E for Erase on/off 
Enter for Text Print 
F for Flash on/off 
Fire for curser Plot on/off 
K for Alternate Curser Speed 
PF for Paper Colors 
V for Video Mode Selection 
X for the Graphics Editor Menu 
Any other key to return to the design screen. 


2.1 INK COLORS 


Press a number O to 7. Ink = "number” will Flash briefly and the 
color associated with that number will be used until the next 
INK command is given. This new ink color will be poked into the 
screen attribute file everywhere the curser goes. Thus, 
everywhere that you move the curser, the colors will change to 
those of the curser, paper and ink, bright and flash. This is 
true if plot Csee section 2.8) is on or off. 


e.c BRIGHT 


Press "B”. If BRIGHT is of F, it will toggle to.cn. IF it is on, 
it will turn off. The appropiate message will Flash briefly and 
the Bright attribute will be modified wherever the curser goes. 


evs CIRCLE 


Press "C”. You will be prompted to type in the desired CIRCLE 
radius Cin pixels). Type an integer number and press "Enter”. IF 
the desired circle goes off screen, you will be given a warning 
and new data will be requested. (The circle will be drawn around 
the current curser position.) 


Note: the CIRCLE command and DRAW LINE/ARC command below use the 
standard commands accessed through Basic. Thus the ink -cixel 
colors will only be used in the standard video mode. The 
extended color video mode will probably have a color contrasting 
with the paper color. Also, if these functions are callec from 
the high resolution video mode, only the primary d:splay file 
will be effected resulting in a dashed line, arc, or ceircle. 
Similarly, simce these commands only effect the primary display 
File, they will appear to show on the screen at an "X" location 
of twice your curser postion. But this is only because they are 
using an "X%”" value in the 322 column mede instead of 64! 


een DRAW LINE or ARC 


Press "D". The Draw function can draw either LINES or ARCS 
depending on the user commands. You will be prompted for an "X" 


distance (in pixels). Type in an integer number and press 
“Enter”. Positive is to the right, negative is to the left. 
Next, you will be prompted for a "Y" distance. Type in an 
integer number and press "Enter”. Positive is up, negative is 


down. If the X and Y distances are valid Cremain on the screen), 
then you will be prompted for an arc command. Type ina real or 
integer number. Zero is a straight line From the curser position 
to the point defined by the X and Y distance values. A positive 
number provides an arc with a counter-clockwise inflection. A 
negetive number produces an arc with a clockwise inflection. The 
greater the magnitude of the number the more curviture ta the 
arc. 


Note: large arc commands may go off the screen. IF this happens, 
PS/GE 2068 will attempt to catch this error and provide an error 
warning. See section 4.S. Press "Enter” to continue. PS/GE 2068 
will attempt to restore the design to the condition just prior 
to the last draw command. Then try a new command. The high 
resolution viceo mode does not support this error trapping and 
will simply stop will an error report. 


feat! ERASE 


Press "=". If ERASE is on, it will toggle off. IF off, it will 
turn on. The appropiate message will flash briefly. When on, 
Erase reverses the normal Function of the curser. Every ink 
pixel that the curser touches is turned tO a paper pixel. Note: 
Erase must be turned off in order to draw even if the curser 
plot Function is turned on! 


2.6 TEXT/ PRINT 


To activate the TEXT PRINT Function, Press "ENTER”. PS/GE e068 
will print text in the standard 3e@ Cor 64) print columns as 
defined by the curser location. The top of the letter is defined 
by the "Y" location of the curser. (This may not be a_=e standarcd 
row location!) Type in the text. Upper and lower case letters, 
Mumbers, punctuation, and most of the = special characters 
accessed with the symbol shift key can be printed. To exit the 
Text/Print mode, press "Enter” again. Text corrections must be 
made by re-typing over the old text. Note: as each character is 
typed, the "X" coordinate is updated. When a line is completed, 
a new line will automatically start. When the last line is 
completed, the curser will move to the top of the page and 
continue. 


=aew A FLASH 


Press "F"”. If FLASH is off, it will toggle to on. IF it is on, 
it will turn off. The appropiate message will Flash briefly and 
the Flash attribute will be modified everywhere that the curser 
goes. 


2.8 DRAW/PLOT 


The DRAW/PLOT fFuntion is used to draw on the screen with the 
joystick. To activate the PLOT function, Press "FIRE” Cthe Fire 
button on your joystick). IF Plot is off, it will toggle to on. 
If plot is on, it will turn off. The appropiate message will 
Flash briefly. While on, the curser will turn each paper pixel 
it touches to ink (Cproviding Erase 1s turned off). IF Plot ius 
off and Erase is off, moving the curser across the screen dces 
not affect the pixel directlu, however, the attributes held by 
the curser are continually poked into the screen attribute file. 
Thus the Plot off, Erase off curser mode can be used to edit the 
attribute Files Cink color, paper color, bright, Flash) data. 


e.9 CURSER SPEED 


Press "K". If Curser is off, it will toggle to on. IF it is on, 
it will turn off. The appropiate message will Flash. This is’ an 
alternate curser speed moving 4 pixels at a time instead of the 
normal 1 pixel. Use this to speed up positioning the curser. 
Pressing "Fire” to plot automatically returns to the standard 
curser speed. CHowever, with plot on and activating the 
alternate curser speed, a dashed line can be drawn with every 
Forth pixel turned to ink color.) 


2.10 PAPER COLOR 


To change the PAPER COLOR, Press "P"”. You will be prompted for a 
color (number). Press a number key (0 to 7). The corresponding 
color is indicated on the keyboard above each key. A color 
verification message will Flash briefly. This paper color 
attribute will be used everywhere that the curser goes. (In the 
high resolution, 64% column, mode the entire page will change 
paper color. The ecO68 hardware will automatically select a 
contrasting ink color for you. The ink, bright, and Flash 
attributes are not supported in the 64 column mode.) 


edd VIDEO MODE SELECTION 


To change VIDEO MODES, press "UV". You will be prompted to select 
video mode O (standard 32 column mode), or 1 Cextended color 
mode). These two modes are operated on concurrently and can be 
switched back and Forth at any time. The high resolution C6‘ 
column) video mode must be selected at program initialization 
and must be maintained through out the job since it is not 
compatible with the other video modes. 


¢.le GRAPHICS EDITOR MENU 


To list the Graphics Editor (CGE) menu, and to access its various 
Functions, press "X”. 


The following is a copy of the GE menu. 
GRAPHICS EBLDITOR MENU 


Press C to Copy (duplicate) a screen segment 

D to Digitize a screen segment 

E to Erase a screen segment 

H to Hard Copy (Print) the screen file 

I to Invert a screen segment 

L to Load a new screen 

M to Merge 2 screens 

P to Faint a figure 

R to Rotate a screen segment 

S to Save a screen segment 

W to scale (half size) a screen segment 

Y to make a Mirror Image of a screen segment 
to scale (double size) a screen segment 
Any other key to return to the design screen. 


N 


3.0 GRAPHICS EDITOR MENU 


The GRAPHICS EDITOR menu (GE) can be listed and the GE functions 
accessed by pressing "X”. With the GE menu displayed, press’ the 
key assigned to the desired function, or any other key not 
assigned to a Function Clike ENTER) to return to the design 
screen. Note, you must press "X%" to display the GE menu before 
you can access any GE functions! 


Most of the GE Functions operate on a user defined "Window" or 
screen segment. This window is drawn Coverlayed) upon the design 
screen and can be moved anywhere on the screen through simple 
joystick commands. The size of the window can be changed with 
the Following keys: 

Press to make the window Larger 
to make the window Smaller 
to make the window narrower 
to make the window shorter 
to make the window taller 
to make the window wider 


ONC UWE 


When the window is properly sized and positioned, press the 
“FIRE” button on your joystick to execute the function. When the 
Function is complete, you will be prompted with SAVE? Press "Y” 
or "N”. See section 4.3. 


Whenever a GE Function is used that requires a_ window, the 
screen attribute file (colors, Flash, or bright data) is lost. 
This is because there was not enough memory available to store 
it. This may be over come in the Future with high speed data 
storage devices like a Floppy disk. For now, it is advisable to 
leave the painting and coloring until the last so you do not 
loose your colors. 


Sad COPY 


With the GE menu displayed, press "C”. The COPY Function is used 
to duplicate or copy the contents of the "window" to ao new 
location. "COPY FROM” will Flash briefly at the bottom/center of 
the screen, then a window will appear in the center of the 
screen. Adjust the size, shape, and location of the window as 
desired. Press "FIRE” on your joystick. "COPY TO” will flash 
briefly. Use the joystick commands to move the window to the 
desirec copy location and press "FIRE”. PS/GE 2068 will scan the 
"FROM" window and create a new copy in the "TO” window. 


see DIGITIZE 


With the GE menu displayed, press "D”. The DIGITIZE Function is 
used to "digitize” the picture segment in the user defined 
window. The digitize Function displays the decimal and binary 
equivalence of the screen display File. This data can be used 
Coutside PS/GE cCO68) to define user defined graphics characters. 
The data is identified by its row and column numbers relative to 


the upper-left corner of the user defined window. Digitize will 
analize an 8x8 pixel element. Then you will be prompted to press 
"C” to make a printer "copy” of the screen. Any other key will 
continue with the next element until the entire window has’ been 
digitized. 


3°35 ERASE 


With the GE menu displayed, press "E”. The ERASE Function is 
used to erase a screen segment. Everything inside the window 
will be erased. In the high resolution video mode (C64 column 
mode), this Fuction 1s used to erase the entire page. 


324 FILL/SHADE 


With the GE menu displayed, press "F”. The FILL/SHADE Function 
is used to fill or shade a closed figure. This Function does not 
use a window. To use FILL/SHADE, use the Following procedure: 

1) position the curser in the desired closed figure 

2) select the desired ink and paper colors 

3) Press "X", then oress "F" to execute FILL/SHADE 
You will be prompted for a FILL/SHADE pattern. This is an 86 
number patter cansisting of ones or zeros. Each "1" represents 
an ink dot, each "O”" represents a paper dot. A total of e56 
shading patterns are available. Note: "OOQOO0000”" would result in 
changing only the paper color in a window segment. PUTT 
would be the same as painting, see section 3.9. 

4) Type your 8 number FILL/SHADE pattern, press "ENTER" 
Note: see section +.e Important Notes and Operating Hints —- 
Paint/Shade. 


3.5 HARD COPY 


With the GE menu displayed, press "H”. The HARD COPY funtion 
will send a screen copy to the 2040 type printer. In the high 
resolution mode, the CO4O printer produces a rotated picture of 
64 Lines and 24 columns. IF you implement the full size printer 
modification, then HARD COPY (Cand the digitize screen copy) 
Functions call the printer interface code loceted ain RAM at 
23°96. See section 7.0. 


36 INVERSE 


With the GE menu displayed, press "I". The INVERSE Function 
changes every paper pixel inside the user defined window to 
paper, and every paper pixel is changed to ink. The effect is 


the same as looking at a photographic negative. 


Th, 


3.7 LOAD 


With the GE menu displayed, press "L”. The LOAD Function reads 
Cloads) screen data into memory. Be sure that the tape is 
properly positioned since PS/GE eO6B does not differenciate 
between screen Files and will read the First file it finds. See 
section 4.1 Important Notes and Operating Hints - Loading and 
Saving Screen Data. 


3.8 MERGE 


With the GE menu displayed, press "M”. The MERGE Function is 
used to combine (merge) e designs into 1. With 1 design already 
in memory (Load 1 if necessary), after pressing "NM", you will be 
prompted to "START TAPE”. PS/GE e058 will load (see section 
3.7). You will then be prompted for the merge procedure: merge 
screen 1 Cold) into screen © (new), screen e (new) into screen 
1 Cold), etc. Press the key associated with the desired option. 


Next, you will Follow a "COPY” tupe Function locating the screen 
segment to be copied From the one screen into the other, see 
section 3.1. Note, MERGE destroues all the colors and other 
attributes of both screens being merged. 


3.3 PAINT 


With the GE menu displayed, press "P”. The PAINT function is 
used to paint/color closed Figures. Postion the curser inside 
the desired Figure. Select the desired colors for paper and ink 
Calso select other flash or bright attributes), and execute the 
paint Function. This procedure is identical to steps 1-3 of the 
FILL/SHADE Function. See section 3.4. 


3.10 ROTATE 


With the GE menu displayed, press ”"R”. The ROTATE function is 
used to rotate a screen segment (window) 30 degrees clockwise. 
This is a Flat (2 dimensional) rotation. Note that by 
definition, the window for this function must be square. The 
largest window segment that can be rotated is 158x168 pixels. 


S211 SAVE 


With the GE menu displayec, press "S”. The SAVE Function "Saves” 
the screen file to tape. Position the tape, as prompted tupe in 
the screen/File name and press “ENTER”. The standard video mode 
will save 1 screen File. The extendec color mode and the high 
resolution video mode both save 2 files (note: a key must be 
pressed between the saves to start the save of the seconfd 
File). See section 4.1 Important Notes. and Operating Hints - 
Loading and Saving Screen Data. 


3142 WIDE 


With the GE-menu displayed, press "W". The WIDE view function 
scales the window segment to one half its original size. A 
double window is displayed for this Function. The contents of 
the large window will be scaled down to Fit the smaller window. 


3.13 MIRROR 


With the GE menu displayed, press "Y". The MIRROR image function 
creates a cight hand mirror image of the window segment. A 
double window is displayed for this Functicn. The ccntents' of 
the left hand side of the window will be reflected to the right 
hand side of the window. 


3.14 200n 


With the GE menu displayed, press "2". The ZOOM Function scales 
the window segment to twice its original size. A double window 
is used for this Function. The contents of the smaller window 
are scaled to Fit the larger window. 


4.0 IMPORTANT NOTES AND OPERATING HINTS 
4.1 LOADING AND SAVING SCREEN DATA 


When LOADING and SAVING screen data with the PS/GE 2068, it is 
very important to note which video mode you are in. CIF you are 
not sure, use the VIDEO MODE SELECT Function to select what you 
need). The stardard video mode will load and save 1 screen file 
while the other video modes save and load e files. If you are 
not in the cight mode, you may end up needing a second display 
file that does not exist, or need to load a second but be unable 
to. YOU MUST BE SURE TO LOAD FILES IN THE SAME MODE THAT THEY 
WERE SAVED. When in the high resolution video mode C6% column 
mode), PS/GE 2068 temporarily switches into the 3e column mode 
for loading and saving data. This temporarily distorts your 
picture, but allows you to see the usual load/save lines on the 
screen. The high resolution mode will be restored once the 
load/save is completed. 


toe PAINT OR SHADE 


When PAINTING or SHADING complex figures, it may be necessary to 
use more than 1 paint/shade command to fill the Figure. Both of 
these Functions operate on the screen File in every direction 
FROM the curser position TO the first ink pixel encountered ina 
given pixel row. The painted Figure must be closed (Chave a 
continuous line defining its shape - like ae circle) or 
paint/shade will escape from the figure and fill the = screen. 
Paint and shade will not re-paint or re-shade a figure since 
these will be full of ink pixels. Hint: try to place the curser 
in the center of complex Figures. 


i a, YES/NO Coops!) 


Perhaps the best time and effort saving feature For such a 
program is an oops! feature. PS/GE eCO68 has one. After each 
Function 1s completed, you will be prompted with Save? Press "Y" 
if you want to keep the present screen. Press "N” if you want to 
restore the old screen. If you made an error anc initiated a 
Function you did not want, or made some other mistake, let the 
Function go to completion, then use the "oops” function to 
restore the old screen For you. Note: even though the des:gn 
screen is restored, the color file for the extended color mode 
is gone. The color file of the standard video mode however is 
restored. Also, one very important note, after each GE Function, 
the curser always goes to coordinates X"0O and YO (the left hand 
corner of the page!) 


bp a COLOR RESOLUTION 


The TS 2068 color computer color resolution is at most 


1 ink 
color and 1 paper color per 8x8 pixel element in the standard 
video mode. Each row has 3e &x8 elements, and there are =2 E&xs 


rows that you can draw on. In the Extended Color video mode, 
each 1x68 pixel element can have 1 paper color and 1 aink cstloc. 
Each row has 3e 1x8 elements, but now there are 175 pixel rows 
(each can each have a different set of colors). In the high 
resolution mode, the entire screen page is fixed to have 1 paper 
and 1 ink color, but now each row has 64 8x@ pixel elements, and 
there are ce 8x8 element rows avallable to draw on. 


$5 ERROR TRAPPING 


The PS/GE e068 program has error trapping in it. If an error 
occurs, an error warning is displayed and the program pauses 
while you are prompted to press "ENTER” to continue. PS/GE 20528 
will attempt to restore the design screen to the condition it 
was in prior to the last command. Error trapping in not 
supported in the high resolution video mode. 


If you need to stop program execution and restart later, try: 
GOSUB 320: GOTO 30 


S.0 DEFINITION OF PROGRAM VARIABLES 


PS/GE C068 uses "Basic” to control the program logic, poke 
values into-the machine code variables, and call various machine 
code routines to perform the Graphics Editor Functions. This is 
a brief description of the program variables that interface the 
basic and machine code halves of the PS/GE 2O68 program. 


UARIABLE MEMORY DESCRIPTION 

NAME LOCATION 

vv: $7333 Cucser location Cvertical) 

xX $7338 Curser location Chorizontal) 
LAST $7937 Last curser value 

LOC S$7336/5 Curser screen location 

C2S6°Peek S7S39S + peek S7996) 
FIRE $7334 -l if Fire is pressed 
O if fire is not pressed 

ATR $7333 Curserc attribute value 

SAVE $793Se Current curser value 

ERASE $7391 -c if Plot is on 


1 if Erase and Plot are off 
O if Erase is an 


X1 $7330 Left side of window 
Yl $7989 Top of window 
TEXT $7989 Code of Text character 
mode $7988 Video Mode Flag 
Ye $7387 Bottom of window 
Joystx $7386 -1 for window 
O For cursec 
Xe $798S Right side of window 
not used $7984 
net used $7383 
not used $798e 
X3 $7981 Hi Res. (X = @56*Peek S7981 + X) 
SPD 57380 Curser Speed Value 
DIGUAL $7979 Digitize decimal value 
Bytes $79378-1 Digitize Binary bytes 
Shade $7976-1 Shade 6 bit pattern 


Note: these variable names are for use/definition only and may 
not be the same as used in the PS/GE BASIC. 


6.0 


DEFINITION OF MACHINE CODE ROUTINES 


The Following is a brief description of the machine code used in 
the PS/GE eO68 program. 


MACHINE ENTRY 
ROUTINE ADDRESS 


High 


Rl 56000 
Re 56014 
R3 56031 
R4 S6OY4S 
RS S60S7 
R6 560693 
R7 S6081 
RB 56093 
RS 56043 
R10 $8835 
R11 6068e 
Rle 61103 
R13 61685 
R14 62316 
R15 6eS50e 
R16 49386 
R17 S6e4%3 
R18 57133 
R193 S76Se 

$6105 


resolution video mode 


Rio $8535 
Rill 61585 
56150 


DESCRIPTION 


Copy attribute File 1 to File e 
Initialize display File e CEC mode) 
Copy attribute File e to File l 
Copy display File e to File l 

Copy display File 1-to 49800 (File 3) 
Copy File 3 to display File 1 

Copy display File 1 to file eé 

Copy display File e to File 3 
Rotate Function 

Plot Function 

Print Text Function 

Zoom Function 

Wide Function 

Erase Function 

Copy Function 

Paint/Shade Functions 

Mirror Image Function 

Digitize Function 

Inverse Function 

Set up alternate video mode code 


codes. 
Plot Function 


Print Text Function 
Hard Copy CeO4tO printer) Utility 


7.0 Full Size Printer Modification 


The following modifications are the minimum required to route 
printed sutsut From the PS/GE e068 to a full size printer. Since 
you supply your own interface software, this modification should 
allow any printer/interface to run Cassuming that the memory 
locations are compatible.) 


Since I am srly Familiar with the TASMAN interface, I will only 
address this software, although others should be similac. The 
screen/graorics ccoy (or high resolution screen copy) code as 
the TASMAN documentation calls it, executes From memory reserved 
for the 2040 print buffer starting at 23e96 and extending to 

SESS. For ease of code loading, we will place the interface 
code higher in RAM and have it relocated prior to execution. The 
PS/GE 2O0SE hes free memory above location 62760 and below the 
relccated system code (around 65256 I beleive). This is where 
the print driver code will be placed. Other print driver codes 
may be placec here and executed from this location if they are 
net too long (where they will be over-written by system code). 


The Following & short steps should get you on the way to 
printing your PS/GE e068 output on full size printers. 


Shen Ls Load the PS/GE 29068 program. 


LOAD "PS/GE 2058” 
When the "STOP TAPE” alert is displayed, break the program using 
the Cap Shift + Break keus. 


Lee 


tea Se Modifv the "“EBASIC" program. 


Type the Following lines. (Do not edit existing lines.) 


25 RANDOMIZE USR VAL "E3020": CLS : GOSUB VAL "100" : ON ERR 
GOTO VAL "3390" 

929 1F cS = "H" OR cS - "Hh" THEN GOSUB VAL "3500" : GOTO VAL 
” 30 iy 


DELETE LINE £50 


1560 PAUSE UAL "0" : LET bS - INKEYS : IF bS = "C” OR bS - "c” 
THEN GOSUB vAaL "500" : CLS 


9500 RANDOMIZE USR VAL "23296" : RETURN 


ageg SAUE "PS/GE 2058” LINE O : SAVE "PS/GE 2068” CODE 
4¥e@500,14525 


> 


Load the Interface Code. 


will use into 
I will use the 


Load the particular printer interface code you 
memory starting at 62760. For my Star Gemini 10, 
tas-starg code. 


LOAD "tas-starg” CODE 62760 Cpress ENTER] 
Step 4: Poke in the interface relocation code. 
Poke the following numbers into the assigned locations. This 
code is executed by: RANDOMIZE USR 630c0. 
POKE 63020,17 POKE 63021,0 POKE 63022,91 
POXE 63023,33 POKE 630ec4%,40O POKE 630eS,c4S 
POKE 63026,1 POKE 63027 ,0 POKE 630ce8,1 
POKE 6302e9,237 POKE 63030,176 POKE 63031,2e01 
Step S: Save the new "BASIC" and Code. 
Save your updated PS/GE C068 program on a new tape. 
TYPE: GOTO 3939 Cpress ENTER) 
Steps 6, 7, and 6 update the print driver code for the true 64 
column Chigh resolution mode graphics). This modification will 


work only for those printers that use the TASMAN code for EPSON, 
STAR, and SHINWA type printers. Other print drivers might te 
modified in a similar fashion. Two POKES are used to call a 
short machine code subroutine outside the print driver code. 
This code is located at 6254S. The 62S4%S code controls’ the 
“pointer” that locates data in display File 1 or 2 used in this 
advanced video mode. It may be possible to redirect your 
particular interface code to this same routine. 


Step é: Load the 64 Column Mode Machine Code. 
TYPE: LOAD "hi res” CODE Cpress ENTER) 
Step 7: Poke in the Hi Res Print Driver Code. 


POKE 62819S,61 6eBeo ,ct4 Cre-directs print driver) 
POKE 62°911,196 (use display File e@ for alternate columns) 


POKE 62eS45,e0S 6eS46,75 6eS47 ,391 6eS4+6,eeg 
POKE 62549,213 6eSSO,e213 6eSS1,ees 6eSS2,17 

POKE 62S553,0 6ess4, 3e 6essS,eS 62SS56,235 
POKE 62S57,2e25 62SSB,ees 6essg9,eo0s 62S60,75 

POKE 62561,91 62eS56e,ee9 62S63,e13 6eS64,eeS 
POKE 62S65,17 62S66 ,0 62567 ,32 62S68 ,237 
POKE 625593,8e 62S70,2e35 62S71,eeS 62572,e01 
Note: your print driver code must be "POKED” to produce 


the large size page. 


CPOKE 63015,0) 


Step 8: Save your Hi Res Code. 


TYPE: SAVE "hi ces” CODE S6150,688S Cpress ENTER) 


Now you are ready toa use the PS/GE eO68 with a Full-size 
printer. 


ADVANCED PRINT DRIVER MODIFICATION: 

It is pessible to use lines 9500-93700 of "BASIC" to select page 
size, location, etc. | have included a section of code 1 use 
with my Star Gemini 10 as an example of what can be done. With 
this code I can select 11 sizes of printout and 3 page locations 
Cleft, center, or right justified). Note, however, there is very 
little memory available For "BASIC” modification with the 
program as is. To open more memory for your new code, go through 
the existing BASIC and change every integer constant to a string 
constant as shown below. 


old: PRINT AT 10,0;" etc. ..... " 

new: PRINT AT VAL "10", VAL "0";" etc. ..... = 
This will slow BASIC execution slightly, but will allow for 
more BASIC to be used in your print driver modification. IF you 
do nct allcw enough coom, as the program runs, the variables in 
RAM will eventually expand and over-write some of the PS/GE cO50 
machine ccde, which if used will "lock up” your system. 


It is not practical Cor possible) for me to explain in detail 
just what must be done to adopt every interface to this program. 
But, what I can try to do is to explain a little of this program 
to ease your job of expanding your printer interface software to 
a more “useful” Form. My printer, a STAR GEMINI 10 has’ several 
different graphics modes that determine the dot density, and 
thus the page size. The TASMAN code also has the option of e 
sizes. My BASIC code allows me to choose from 11 sizes of 
output. There are really 12 possible (6 printer x 2 software), 
but the largest size does not Fit on an 8 inch wide sheet of 
paper. I can also select where on the page to place this output. 
This is done by inserting blank columns befcre = printing the 
graphics data. Now, all this is already done by the TASMAN 
interface code, I simply found out where and how it was done and 
modified it by pokes from BASIC to change forms as 1 required. 
My pacticular TASMAN code had 3 data tables imbedded in the 
code. I simply needed to pceke data into the tables to change the 
print mode, leading blanks, and number of pcints plotted per 
line. CActually it was a little more difficult than that since 
the standacd graphics mode and all the TASMAN tables were set up 
for 4 data points. When I went to the alternate graphics modes, 
Il needed to change all the tables to hold and read S points. 
This meant moving these to new locations and re-directing the 
"loads” that read the tables.) 


Gr 


Once this is accomplished, all you need to do is to set up the 
data in BASIC to match the desired graphic commands. In the 
sample program, I POKE 4 numbers into the interface code for 
each size of output. This data is a table (lines 9650 to 9659). 
Column 1 represents the printer graphics command. Column e is 
the number of points to be plotted devided by eS& (1 = 256 
points plotted, 2 - 512). Column 3 defines a double size (0) or 
single size (1) page. In the double size mode, each pixel on the 
screen creates a exe dot on paper. Note, the data from columns 2 
and 3 are tied together. A single size page will have eS& data 
points, a double size page will have Sle data points. Column ‘4 
defines the number of blank spaces requirec to place this size 
output in the center of the page. 


Just e couple more pointers. ] call 2 subroutines from BASIC. 
LINE 300 saves the screen file in upper RAN and allow you to 
print a menu on the screen. LINE 3c0 restores your design. Both 
of these routines take care of anu video mode changes that might 
be required. Lines 9800 to S&S0 are used to choose between the 
2040 printer and a full size printer. This can be called by 
adding a new line: gees GOSUB VAL "3800" 


I hope that this helps uouw in vour effort to put vuour Full size 
printer interface into the PS/GE e058 program. If you have any 
questions, send me a letter explaining uour problem Calongq with 
a self addressed/stamped envelope) and ! will try to help... Lt 
1 can. 


S D Lemke 
Lemke Software Development 
214%4 White Oak 
Wichita, Ks. 67207 


s3soo 


9510 IF pt- VAL "1" THEN GO TO VAL "93530" 

951S IF mode <- VAL "2" THEN COPY RETURN 

9S20 RANDOMIZE USR VAL "S61S0”": RETURN 

9530 GO SUB VAL "300": GO SUB VAL "S600": GO SUB VAL "320": RANDOMIZE 2oR 

AL "23296": RETURN 

9600 REM Define cutput width 

9610 CLS PRINT AT UAL "S", UAL "0"; "Indicate your desired page size.”;''; 
ress -- O for 7.1 x 4.1"; TAB VAL "10";"1 For 6.4 x 4.1"; TAB VAL "10";"2 Fre 

S.7 x 4.1%: TAB VAL "10";"3 For 4.3 x 4.1"; TAB VAL "10"; "4 for 2.1 x 4.1"; 
B UAL "6"; "ENTER for 4.1 x 2.1"; TAB VAL "10";"S for 3.6 x 2.1"; TA VAL ° 
-"6. Far 3.20 x.e2.1"; TAB. VAL. "10" <"7 For ess x e.1"5 TAB VAL "10";"@ For @.2 
2.1": TAB VAL "6";"or 93 For 1.1 x 2.1” 

9620 PAUSE VAL "0": LET pS~ INKEYS IF mode >- VAL "2" AND Cps<"0" OF FS?” 
THEN GO TO VAL "93S2e0” 

9630 POKE VAL "23481", UAL "O": POKE VAL "23493", VAL "1": POKE VAL "essa: 

UAL "1": LET le= VAL "18": IF pS >= "0" AND pS <= "9" THEN RESTORE © VAL "SE 

+ VAL pS): READ pS: POKE VAL "23491", VAL pS: READ ps: POKE VAL "23483", VA’ 
$: READ pS: POKE UAL "23S48", VAL pS: READ pS: LET lc= VAL ps: GO TO WAL "S 

s6SO DATA ot oo ae 

9651 DATA eres <n © Reena = jal 

96Se DATA ere 

9653 DATA "1","2","0", "18" 

96S4 DATA "3","2","0","e9” 

965S DATA "S","1","1", "ee" 

96S6 DATA "4","1","1", "e248" 

36S7 DATA ane ip eis Waren ast 1 

96S8 DATA "1","1" ae 

gssg DATA oe oye ee SE 

9690 REN Define Margine 

3700 CLS PRINT AT UAL "10", VAL "0";" Indicate page mer gang: were Paes 
- 1 for left justified"; TAB VAL "11","e For page centered”; TAB VAL "1p" 

or right justified” 

9730 PAUSE VAL "0": LET pS= INKEYS IF ps<"1" OR pS>"3" THEN GO TO VAL "S 

9740 IF pS-"1" THEN POKE VAL "23526", VAL "1": RETURN 

97SO IF pS-"3" THEN LET lcwlc® VAL "e” 

9760 LET LC-LC+ VAL "1" 

9770 POKE VAL "235e6",lc: RETURN 

9800 REN Define Printer 

9810 CLS : PRINT AT VAL "10", VAL "O";” Indicate Printer type.”;';” Press 
- 1 for Full Size”; TAB VAL "12";"2 for TS eO4tO type” 

S830 PAUSE VAL "0": LET pS~ INKEYS IF ps<"1" OR ps>"e” THEN GO TO VAL "& 

SB84O LET pt- VAL pS: IF pS<"1" THEN RANDOMIZE USR VAL "63020" 

s8SO RETURN 


REM Hard Copy Printout 4 


